home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / mf / rexx / callmf / readme
Text File  |  1995-03-15  |  5KB  |  153 lines
  1.  
  2. This is version 1.0 of the CallMF package, the ARexx scripts for automatic
  3. font generation with 'PasTeX'.
  4.  
  5.     Enjoy,
  6.       Georg, J\"org, Martin, Ulrich.
  7.  
  8. -----
  9.  
  10. Sorry, the english doc is only a readme.  But if anybody likes to translate
  11. the german doc feel free.
  12.  
  13. Ulrich
  14.  
  15. GERMAN users, please read doc/MFRexx.tex!
  16.  
  17. -----
  18.  
  19. This  file  describes  installation and usage of the programs for automatic
  20. generation of fonts with Metafont (MF).
  21.  
  22. Installation:
  23. =============
  24.  
  25. 1)  copy  the  file  'modes'  to MF:config/ and change it to fit your local
  26. modes.mf  or use the PasTeX-modes.mf which comes with these macros.  If you
  27. want  this then copy #?.mf to MF:inputs/ and don't forget to generate a new
  28. plain.base file!
  29.  
  30. 2)  copy  the  files  'MakeBatch.rexx'  and 'MakeTeXFont.rexx' to the REXX:
  31. directory.  preferably use MF:REXX directory.
  32.  
  33. 3)  set  the  environment variable 'CallMF' to 'MakeBatch' or 'MakeTeXFont'
  34. (you  will  know  which when you have finished reading this text).  Or even
  35. better,  include  the  full  path  to  these  macros  in the variable, like
  36. "MF:Rexx/MakeBatch.rexx".
  37.  
  38.  
  39. MakeTeXFont:
  40. ===========
  41.  
  42. MakeTeXFont produces the fonts.  Call it with the following parameters:
  43.  
  44.  font         name of the font (e.g., cmr10)
  45.  dpi          resolution of the font (e.g., 360)
  46.  hbasedpi     the horizontal ...
  47.  vbasedpi     and vertical resolution of the output-device
  48.  drivertype   the name of the caller (show, print, ...)
  49.  pkfilename   name of the file the font should be saved to
  50.  pkdir        directory, where the pk-file should be saved
  51.               fhe last character of the path must be a '/' or ':'!
  52.  
  53.  
  54. With the command
  55.  
  56.    > rx MakeTeXFont cminch 120 100 100 show 120/cminch.120pk ram:pk/
  57.  
  58. you  can  produce the font cminch for the previewer (100 dpi resolution) at
  59. magstep   1   by   hand.    The   generated   font   will  be  saved  under
  60. 'ram:pk/120/cminch.120pk'.  The directory RAM:pk must exist!  The directory
  61. ram:pk/120 will be created for you.
  62.  
  63. Normally you don't need to know these details since MakeTeXFonts usually is
  64. called by 'ShowDVI', 'PrintDVI' or an automagically generated batchfile.
  65.  
  66.  
  67. MakeTeXFont does the following operations:
  68. - transforming the parameters for MF
  69. - calling MF
  70. - converting  the  font  into  a PK-file  and  moving it to the appropriate
  71.   directory
  72. - renaming the MF-logfile
  73.  
  74. MakeTeXFont produces it's own logfile with an entry for each font generated
  75. in the file mf:log/MakeTeXFont.log.
  76.  
  77. Problem:
  78. You  may  easily run out of memory if there are some other programs running
  79. (especially DVIPrint needs a lot of memory).  If you have this problem when
  80. MakeTeXFont  is  called  from  another  program  use  MakeBatch instead and
  81. execute the batchfile later when there is enough free memory.
  82.  
  83.  
  84.  
  85. MakeBatch:
  86. =========
  87.  
  88. MakeBatch  has  to  be called with the same parameters as MakeTeXFont.  But
  89. MakeBatch  does  not immedeatly generate the font, it only writes a call to
  90. MakeTeXFont in a batchfile which may look like the following:
  91.  
  92.   rx MakeTeXFont SLURDD16 91 91 91 show 91/SLURDD16.91pk TeX:pk/
  93.   rx MakeTeXFont SLURDU16 100 100 100 show 100/SLURDU16.100pk TeX:pk/
  94.   rx MakeTeXFont SLURUU16 120 100 100 show 120/SLURUU16.120pk TeX:pk/
  95.  
  96. Later,  when  you  want  to  generate the fonts simply 'execute' this file.
  97. This method is usefull if many fonts should be generated and you don't want
  98. to  wait  or  if  there  is  not  enough memory to generate fonts while the
  99. DVI-driver is running.  The batchfile gets the name 'mf:MakeTexFont.sh'.
  100.  
  101. MakeBatch  takes  care  if  the  font  to  be  generated  already is in the
  102. batchfile,  so  a  font  is  NOT  generated  twice  if  you preview several
  103. DVI-files where the same font is missed several times.
  104.  
  105.  
  106.  
  107. MakeTeXFontSet:
  108. ==============
  109.  
  110. Produces  a  full set of fonts for a given driver.  Just start it.  It will
  111. ask  you  for  everything.   Make sure you have an empty harddrive, a 68040
  112. Amiga and a lot of time.  For Printers METAFONT will be called 13 times for
  113. ShowDVI  22 times.  Guess how long will all cm fonts need?  IF one METAFONT
  114. call  will take 10 minutes cmr10 will need 220 minutes only for ShowDVI and
  115. another  70  minutes  for  your  printer all in all 300 minutes or 5 hours.
  116. ONLY cmr10, think of all the other cm-fonts.
  117.  
  118.             CAUTION! BY USING THIS MACRO!!!
  119.  
  120. General:
  121. =======
  122.  
  123. All  programs  are  in  the  public  domain.   You may copy and modify them
  124. freely.
  125.  
  126. I've  done all my fontmaking with the help of these programs, but there are
  127. certainly some 'undocumented features'!
  128.  
  129. Send bugreports, your own improvements and new ideas to:
  130.  
  131. Martin Bokaemper
  132. Reuthstr. 12
  133. 91099 Poxdorf
  134. Germany
  135.  
  136. email: mnbokaem@cip.e-technik.uni-erlangen.de
  137.        mab@ame.ZER  (Zerberus)
  138.  
  139. PS.: Since these files may go through several different machines via
  140.      email I took the 'international version' of my name. If you use
  141.      TeX or something else that can handle 'umlauts' write to
  142.      Martin Bok\"amper instead of Bokaemper. :-)
  143.  
  144. or try:
  145.   hessmann@unipas.fmi.uni-passau.de
  146. or:
  147.   hoehle@cs.uni-sb.de
  148. or
  149.   Ulrich Wisser      ! Always use this address for MakeTeXFontSet.rexx
  150.   Heerstr.  125
  151.   53111 Bonn
  152.   G E R M A N Y
  153.